TimescaleDB 是一个旨在使 SQL 可扩展以适用于时间序列数据的开源数据库。 它由 PostgreSQL 设计并打包为 PostgreSQL 扩展，提供跨时间和空间的自动分区（分区键）以及完整的 SQL 支持。

本小节主要介绍如何升级 timescaleDB 插件至 1.7.3 版本。

仅支持升级到 PG11-高可用版-1.0.9 及以上版本的集群。

仅支持升级到更高版本。

已获取管理控制台登录账号和密码，且已获取集群操作权限。

升级插件前，请执行验证更新版本影响操作。

节点状态活跃，节点服务状态正常。

登录管理控制台。

选择产品与服务 > 数据库与缓存 > 关系型数据库 PostgreSQL，进入集群管理页面。

点击目标集群 ID，进入集群详情页面。

备份原集群，详细操作请参见创建备份。

备份数据库并保存备份文件。

由于 timescaleDB 1.6.1 版本 release note 说明，For this release only, you need to restart the database after upgrade before restoring a backup.因此，升级前需要使用 pg_dump 进行数据库的备份工作。

timescaleDB release notes：https://docs.timescale.com/timescaledb/latest/overview/release-notes/#main-content

判断当前备份集群版本是否为 PG11-高可用版-1.0.9 版本。

是，执行下一步。

否，请升级该集群版本到 PG11-高可用版-1.0.9 版本，详细操作请参见升级版本。

升级备份集群的 timescaleDB 插件。

使用数据库连接软件（PgAdmin、DBeaver 或直接使用 psql）通过 root 账户连接数据库高可用写IP。

如果您正在使用 psql，请与 -X 标志连接，以防止任何命令在 .psqlrc 会话启动时加载以前的 TimescaleDB 版本，示例如下：

-U

数据库超级管理员账号名。

root

-h

数据库节点 IP 或集群的高可用写 IP

192.168.100.0

-p

端口号

-

-d

数据库名称。 新建数据库默认名称 qingcloud。

qingcloud

-X

psql在连接数据库之前，首先会读取并执行改文件中的命令，然后连接到数据库，如果加上-X参数，则跳过该文件。通过该文件可以设置客户端或者是服务端的风格。

-

执行如下 SQL 语句更新 timescaleDB 版本至 1.7.3：

注意：需要将更新语句作为连接数据库后的第一条命令执行，否则执行会报如下错误：

验证数据。

若数据无误，则升级完成，可升级原集群 timescaleDB 插件。

若数据异常，请使用 pg_restore 从备份文件中恢复数据库。若能正常恢复，可升级原集群 timescaleDB 插件；否则，请联系技术支持。

备份数据库并保存备份文件。

由于 timescaleDB 1.6.1 版本 release note 说明，For this release only, you need to restart the database after upgrade before restoring a backup.因此，升级前需要使用 pg_dump 进行数据库的备份工作。

判断原集群版本是否为 PG11-高可用版-1.0.9 版本。

执行该操作前，建议备份集群，详细操作请参见创建备份。

是，执行下一步。

否，请升级该集群版本到 PG11-高可用版-1.0.9 版本，详细操作请参见升级版本。

升级原集群的 timescaleDB 插件

使用数据库连接软件（PgAdmin、DBeaver 或直接使用 psql）通过 root 账户连接数据库高可用写IP。

如果您正在使用psql，请与-X标志连接，以防止任何命令在.psqlrc会话启动时加载以前的 TimescaleDB 版本，示例如下：

-U

数据库超级管理员账号名。

root

-h

数据库节点 IP 或集群的高可用写 IP

192.168.100.0

-p

端口号

-

-d

数据库名称。 新建数据库默认名称 qingcloud。

qingcloud

-X

psql在连接数据库之前，首先会读取并执行改文件中的命令，然后连接到数据库，如果加上-X参数，则跳过该文件。通过该文件可以设置客户端或者是服务端的风格。

-

执行如下 SQL 语句更新 timescaleDB 版本至 1.7.3：

注意：需要将更新语句作为连接数据库后的第一条命令执行，否则执行会报如下错误：

验证数据。

若数据无误，则插件升级完成。

若数据异常，请使用 pg_restore 从备份文件中恢复数据库。若不能正常恢复，请联系技术支持。